home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr28 / fill502.zip / BRUCE502.DOC next >
Text File  |  1995-02-21  |  30KB  |  619 lines

  1. BRUCE502.DOC
  2. 02/21/95
  3.  
  4. --------------------------------------------------------------------------------
  5.  
  6. Contact information:
  7.  
  8. For the following routines:  AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL,
  9. FILL, FIXTEXT, FORTUNE, MULTICOL, PAGINATE, READINIT, and READMAKE-created
  10. files:
  11.  
  12.                 Bruce Guthrie
  13.                 Wayne Software
  14.                 113 Sheffield St.
  15.                 Silver Spring, MD 20910
  16.  
  17.                 fax: (301) 588-8986
  18.  
  19. For the following routines:  CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE, and
  20. READ:
  21.  
  22.                 Bruce Guthrie
  23.                 Room H-4885
  24.                 U.S. Dept of Commerce/ESA/STAT-USA
  25.                 Washington, DC 20230
  26.  
  27.                 fax: (202) 482-2164
  28.  
  29.                 E-Mail: bgu@cu.nih.gov
  30.  
  31. Foreign users:  Please provide an Internet-reachable e-mail address in all
  32. correspondence if you have any hope of getting a reply!  Internet e-mail is the
  33. preferred method of contact for all other users as well.  Remember, CompuServe
  34. and Prodigy are now Internet accessible.
  35.  
  36. Since these programs are typically "freeware" (with the exception of people
  37. trying to make money from them instead of me), they generate maybe $100/year in
  38. revenue for me.  As such, my ability to afford wonderful customer support is
  39. somewhat restricted.  Please do not leave messages saying "Call me long
  40. distance".  Also, please be specific about what problems you encounter and
  41. include command-line inputs as well as any control or INI files that you're
  42. using.
  43.  
  44. The "production" releases of these programs are posted directly by me (Bruce
  45. Guthrie, the author) on the Simtel ftp site at oak.oakland.edu.  More
  46. information about locations at this site is provided later.  People are
  47. encouraged to upload them to bulletin board systems but I do not upload them to
  48. BBS's myself.
  49.  
  50. Standard disclaimer in this society:  Wayne Software disclaims all warranties as
  51. to this software, whether express or implied, including without limitation any
  52. implied warranties of merchantability, fitness for a particular purpose,
  53. functionality, data integrity or protection.
  54.  
  55. --------------------------------------------------------------------------------
  56.  
  57. Introduction:
  58.  
  59. This documentation provides some overview information on a number of utilities
  60. that have been posted by Wayne Software.  All programs described herein were
  61. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  62. Others were written for the U.S. Department of Commerce.  All are free for use
  63. provided relevant documentation is kept with the programs, no changes are made
  64. to the programs or documentation, and they are not bundled with commercial
  65. programs or charged for separately.
  66.  
  67. CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE, and READ are excluded from the
  68. commercial packaging restriction.  These programs are owned by the U.S.
  69. Department of Commerce and may be re-distributed without restriction.
  70.  
  71. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL, FILL,
  72. FIXTEXT, FORTUNE, MULTICOL, PAGINATE, READINIT, or READMAKE files in commercial
  73. packages other than shareware/freeware collections must pay a $50 registration
  74. fee to "Wayne Software" at the following address.  READMAKE-created files are
  75. also subject to this limitation.  I don't expect to make any money from these
  76. utilities but I don't want others to sell them instead.
  77.  
  78. The utilities are uploaded with a ZIP name that includes the year and month of
  79. the release.  The year and month are represented as "ymm" below.
  80.  
  81.          ZIP file         Executables included
  82.  
  83.          AVymm.ZIP        AV.EXE
  84.          BFINDymm.ZIP     BFIND.EXE
  85.          CHANGymm.ZIP     CHANGE.EXE
  86.          CONVRymm.ZIP     CONVERT.EXE
  87.          COPSymm.ZIP      COPSINCE.EXE
  88.          DATESymm.ZIP     DATES.EXE
  89.          DIRCOymm.ZIP     DIRCOMP.EXE
  90.          DIRTOymm.ZIP     DIRTOTAL.EXE
  91.          FILLymm.ZIP      FILL.EXE
  92.          FILUPymm.ZIP     FILUPDAT.EXE
  93.          FIXTXymm.ZIP     FIXTEXT.EXE
  94.          FORTNymm.ZIP     FORTUNE.EXE
  95.          ISAMFymm.ZIP     ISAMMAKE.EXE, ISAMFIND.EXE
  96.          MULCOymm.ZIP     MULTICOL.EXE
  97.          PAGINymm.ZIP     PAGINATE.EXE
  98.          READymm.ZIP      READ.EXE, READINIT.EXE, READMAKE.EXE
  99.  
  100.  
  101. This collection of utilities were compiled using Microsoft's Visual BASIC for
  102. DOS 1.0 compiler.  In each case, Thomas G. Hanlin III's excellent PBClone
  103. routines, release 2.3, provided additional functionality.  Since Tom has
  104. announced that he will be dropping support for his PBClone routines to allow
  105. himself to spend time on a real life, future directions for my routines is
  106. uncertain.  The basic routines should be able to be maintained indefinitely;
  107. we'll see.  I keep thinking that I should be doing Windows programming but it's
  108. hard to get psyched up for that when you think of Windows as a computer virus.
  109.  
  110. Each of the utilities are separately described in a like-named *.DOC file.  This
  111. documentation (BRUCEymm.DOC--the file release date is indicated by the "ymm"
  112. parameter) serves to summarize what the various utilities consist of.
  113.  
  114. Most of the routines have defaults that can altered by using initialization
  115. files (inifiles).  These are described in the appropriate documentation.  (One
  116. thing about *.INI files; if you don't have one, it's in your interests to
  117. specify the "/-I" parameter.  Otherwise, the program searches your entire DOS
  118. path looking for the file.)
  119.  
  120. Wayne Software also writes programs, batch files, and sets up menu systems for
  121. people on a for-fee basis.  If you desire this service, contact Wayne Software
  122. at the address specified above.
  123.  
  124.  
  125. --------------------------------------------------------------------------------
  126.  
  127. Summary of programs:
  128.  
  129. A summary of each routine follows.  See the associated *.DOC files for fuller
  130. explanations:
  131.  
  132. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  133. etc) and lets you sort as desired.  Also allows resetting of the file date based
  134. on the archive's contents.  Syntax:
  135.  
  136.     AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /DATE ] [ /Iinitfile | /-I ]
  137.       [ /MOUSE | /-MOUSE ] [ /Q ] [ /? ] [ > filename ]
  138.  
  139. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  140. one string AND another one, or any line with one string OR another.  The syntax
  141. shown below is incomplete since "search" allows a lot of choices and allows the
  142. use of parens and Boolean operators.  Syntax:
  143.  
  144.     BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ]
  145.       [ /-HEADER | /HEADER ] [ /Iinitfile | /INULL ]
  146.       { search } infile [ /? | /?&H ] [ >filename ]
  147.  
  148. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  149. type (e.g.  binary or text) and are processed quickly.  Up to thirty change
  150. commands can be processed in a single pass.  Also provides ability to remove
  151. trailing spaces from text files.  Syntax:
  152.  
  153.     CHANGE infile [ /Cctlfile | /FROM string /TO string [ /IN search ] ]
  154.       [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ]
  155.       [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ]
  156.       [ /Iinitfile ] [ /Fflagfile ] [ /Ttempfile ] [ /TRIM | /-TRIM ]
  157.       [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? | /?&H ]
  158.  
  159. CONVERT.EXE:  Converts data between data formats:  FROM dBase, ASCII-delimited
  160. (commas between fields and quotes around strings), and fixed field TO Lotus WKS,
  161. ASCII-delimited, dBase, and fixed field.  Syntax:
  162.  
  163.     CONVERT infile [ outfile [ deffile ] ]
  164.       [ /INDEF=deffile | /-INDEF ] [ /OUTDEF=deffile | /-OUTDEF ]
  165.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ] [ /Iinitfile | /-I ]
  166.       [ /FROM FIXED | /FROM ASCII | /FROM DBF ] [ /DELETED | /-DELETED ]
  167.       [ /TO FIXED | /TO ASCII | /TO WKS | /TO DBF ] [ /HEADER | /-HEADER ]
  168.       [ /DELIMS=aroundstrings,aroundnums,betweenfields ] [ /BEEP | /-BEEP ]
  169.       [ /INMISS=val ] [ /INMISSC=val ] [ /OUTMISS=val ] [ /OUTMISSC=val ]
  170.       [ /SKIP | /MISSING | /ABORT ] [ /NULLS | /-NULLS ] [ /Q ] [ /? | /?&H ]
  171.  
  172. COPSINCE.EXE:  Copies all files modified since a given date.  Primarily used for
  173. making sure you have a back-up of stuff and also to copy updated programs to
  174. another place.  Lets you define your own groupings of files if desired.  Syntax:
  175.  
  176.     COPSINCE [ from_dir | from_dir\filespec [ to_dir ] ] [ /TO to_dir ]
  177.       [ mm/dd/yy | -n | /COPY mm/dd/yy | /COPY -n ] [ /ALL | /TEXT | /filetype ]
  178.       [ /Iinitfile | /-I ] [ /DEF filetype=spec [ spec ]... ]
  179.       [ /REPLACE | /-REPLACE ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  180.  
  181. DATES.EXE:  Simple program that warns you in advance when an event like a
  182. birthday, anniversary, or holiday is coming up.  The idea is to give you advance
  183. warning so you can send a card or get out of town in time.  Syntax:
  184.  
  185.     DATES [ date_file [...] ] [ /Ddays ] [ /SKIP | /-SKIP ] [ /DATE=format ]
  186.       [ /DATE | /-DATE ] [ /DAY | /-DAY ] [ /AGE | /-AGE ] [ /CTDOWN | /-CTDOWN ]
  187.       [ /COLOR=nnn nnn nnn ] [ /MONO | /COLOR ] [ /Q | /-Q ] [ /SORT | /-SORT ]
  188.       [ /GLOBAL | /-GLOBAL ] [ /CLS | /-CLS ] [ /P | /Pn | /-P ]
  189.       [ /W | /W0 | /-W ] [ /R ] [ /Iinitfile | /-I ] [ /? ] [ > filename ]
  190.  
  191. DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds ability to
  192. delete extra files in the destination subdirectory, copy hidden and system
  193. files, and prepare a report showing inconsistencies.  Syntax:
  194.  
  195.     DIRCOMP directory1 directory2 [ /S ] [ /CREATE ]
  196.       [ /UPDATE ] [ /KILL ] [ /CLONE ] [ /MOVE ] [ /ATTR=[H][S][R] ] [ /NET ]
  197.       [ /Frptfile | /-F ] [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  198.       [ /ALL ] [ /Td: | /Td:\path ] [ /Q ] [ /? ]
  199.  
  200. DIRTOTAL.EXE:  Prepares report showing files in subdirectory or drive.  Allows
  201. some restriction requests (show only files with date greater than a certain
  202. value).  Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a
  203. great program but it doesn't work on network or CD-ROM discs) in some ways but
  204. presents a more formal report.  Also allows you to look for duplicate file names
  205. and search by attributes or dates.  Syntax:
  206.  
  207.     DIRTOTAL [ [ drive: ] ... [drive:][filespec] |
  208.         [ drive: ] ... [drive:]\path[\filespec] ]
  209.       [ /NORMAL | /WIDE | /THIN | /SPLIT ] [ /DUPS ] [ /CHILD ]
  210.       [ /NL ] [ /-HEADERS ] [ /-FOOTERS ] [ /CLUSTERS | /-CLUSTERS ]
  211.       [ /S { GT | GE | LT | LE | EQ | NE } value ]
  212.       [ /D { GT | GE | LT | LE | EQ | NE } mm/dd/yy ] [ /ATTR=attr ]
  213.       [ /Frptfile ] [ /Z | /-Z ] [ /Iinitfile | /-I ]
  214.       [ /SUB1 | /-SUB1 ] [ /SUB2 | /-SUB2 ] [ /+DIR | /-DIR ] [ /n ]
  215.       [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /Td: ] [ /Q ] [ /? ]
  216.  
  217. FILL.EXE:  Program designed to move files off to floppy diskettes, taking the
  218. biggest files first and skipping those that won't fit.  Also provides option of
  219. splitting large files up, labeling output disks, and creating a status report.
  220. Syntax:
  221.  
  222.     FILL [ source-filespec | @flistfile ]
  223.       [ [ /TO ] dest-drive: | [ /TO ] dest-drive:\path\ ]
  224.       [ /MOVE | /COPY ] [ /PROMPT | /-PROMPT ] [ /Iinitfile | /-I ]
  225.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ]
  226.       [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE | /-WIPE ] [ /MULTI | /SINGLE ]
  227.       [ /SPLIT ] [ /LABEL=label [ /START=n ] ] [ /Fstatfile [ /S+ | /S- | S* ]
  228.       [ /CONTINUAL ] [ /TIME | /-TIME ] [ /BEEP | /-BEEP ]
  229.       [ /FAKE ] [ /Q ] [ /? ]
  230.  
  231. FILUPDAT.EXE:  Program which compares a selected list of files in a source path
  232. against those in another path and copies those that have been updated.  Similar
  233. to DOS' REPLACE command but works from a stored list of files and can handle any
  234. number of directories.  Syntax:
  235.  
  236.     FILUPDAT ctlfile
  237.       [ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ]
  238.       [ /FULL ] [ /ALL ] [ /Q ] [ /? ]
  239.  
  240. FIXTEXT.EXE:  Program which applies a user-definable character-translation table
  241. to a text file.  Can allow you to convert graphics characters to their ASCII
  242. equivalents, lowercase letters to uppercase letter, etc.  Can also be used to
  243. translate DOS text files to Mac or Unix text files and vice versa.  Can also
  244. expand tabs, remove trailing spaces, and remove backspaces.  Syntax:
  245.  
  246.     FIXTEXT infile { outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] |
  247.       /REPLACE } [ /Iinitfile | /-I ] [ /TEXT | /-TEXT ] [ /EJECT=str ]
  248.       [ /CRLF | /CR | /LF | /-LINE ] [ /TO CRLF | /TO CR | /TO LF | /TO -LINE ]
  249.       [ /WIDTH=n ] [ /Frptfile | /-F ] [ /Q ] [ /? | /?&H ]
  250.  
  251. FORTUNE.EXE:  Program which adds some fine-tuning to the DOS FOR command.
  252. Among other things, this lets you distinguish file name roots from their
  253. extensions as well as increment file names by specified values.  Syntax:
  254.  
  255.     FORTUNE { IN (set) | IN filespec | /IN (set) | /IN filespec | filespec }
  256.       [ /AS filename ] [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  257.       [ /VAR=char ] [ /DELIM=chars ] [ /+n | /-n ] [ /S ] [ /Xfilespec ] ...
  258.       [ /ECHO | /-ECHO ] [ /ABEND | /-ABEND ] [ /PAUSE | /-PAUSE ]
  259.       [ /CHECK | /-CHECK ] [ /Iinitfile | /-I ] [ /? ]
  260.       { DO cmd | /DO cmd | cmd }
  261.  
  262. ISAMFIND.EXE:  Program that works in conjunction with ISAMMAKE.EXE (see below)
  263. to provide full-text searching of text files.  This is useful for helpdesk
  264. applications and other functions where you want to search for files and retrieve
  265. the "best" document that matches your search criteria.  Syntax:
  266.  
  267.     ISAMFIND [ string [ string ]... ] /Fcorename [ /2 | /3 | /4 | /5 ]
  268.       [ /READ | /Vpgm | /-READ ] [ /TOP=n ] [ /TRUNC | /-TRUNC ]
  269.       [ /ACCEPT=string ] [ /AREA=string ] [ /Xfilename ] [ /SINCE=yymmdd ]
  270.       [ /Ofilename | /-O ] [ /OVERWRITE | /-OVERWRITE | /OVERASK | /APPEND ]
  271.       [ /CONT=string ] [ /PATH | /-PATH ] [ /Iinitfile | /-I ] [ /? ]
  272.  
  273. ISAMMAKE.EXE:  Program that works in conjunction with ISAMDEMO.EXE (see above)
  274. to create the files necessary for full-text searching.  Syntax:
  275.  
  276.     ISAMMAKE /Fcorename /Cctlfile [ /C=L | /C=F ] [ /2 | /3 | /4 | /5 ]
  277.       [ /ACCEPT=string ] [ /AREA=string ] [ /CONT=string ] [ /STOP=string ]
  278.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /UPDATE ] [ /SKIP=string ] [ /Td: ]
  279.       [ /Wn ] [ /PACK | /-PACK ] [ /Iinitfile | /-I ] [ /? | /?&H ]
  280.  
  281. MULTICOL.EXE:  Program creates multiple column listings from straight ASCII
  282. text, ASCII-delimited text, or dBase files.  Also does subtotalling.  Can also
  283. be used to add headers and footers to standard one-column text.  Been replaced
  284. by the PAGINATE command.  Syntax:
  285.  
  286.     MULTICOL infile outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  287.       [ /DELIM="string" ] [ /LINES=n ] [ /WIDTH=n ] [ /EJECT | /-EJECT ]
  288.       [ /COLUMNS=n ] [ /-WRAP | /WRAP [ /INDENT=n ] | /REFLOW ]
  289.       [ /Iinitfile | /-I ] [ /SETUP="string" ] [ /RESET="string" ]
  290.       [ /{ TITLE | HEADER | FOOTER }[ R | C | L ][ 1 to 5]="text" ]
  291.       [ /{ TITLE | HEADER | FOOTER }{ T | B }="string" ]
  292.       [ /-TITLE ] [ /FROM FIXED | /FROM ASCII | /FROM DBF ] [ /DELETED ]
  293.       [ /INDEF=deffile | /-INDEF ] [ /OUTDEF=deffile | /-OUTDEF ]
  294.       [ /DELIMS=aroundstrings,aroundnums,betweenfields ] [ /BEEP | /-BEEP ]
  295.       [ /SKIP | /MISSING | /ABORT ] [ /GAP=n ] [ /BLANKS | /-BLANKS ] [ /TALLY ]
  296.       [ /INMISS=val ] [ /INMISSC=val ] [ /OUTMISS=val ] [ /OUTMISSC=val ]
  297.       [ /SUM={ col_spec | var_spec } ] [ /BREAK={ col_spec | var_spec } ]
  298.       [ /PRINT={ col_spec | var_spec } ] [ /? | /?&H ]
  299.  
  300. PAGINATE.EXE:  Program paginates text files, adding titles, footers, indexes,
  301. etc.  Also provides the ability to work with ASCII-delimited text and dBase
  302. files to pop tables into your text.  Can also be used to sort your information
  303. and present it in a multicolumn format.  Syntax:
  304.  
  305.     PAGINATE infile [ outfile ] [ /Cctlfile ] [ /BEEP | /-BEEP ] [ /DEBUG ]
  306.       [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] [ /Iinitfile | /-I ]
  307.       [ /marker command ]...
  308.       [ /? ] [ /?&H ]
  309.  
  310. READ.EXE:  Text file browser.  Supports marking, copying text, reading Unix
  311. and Mac text files, etc.  Only works with files of 16,000 lines or less (maybe
  312. 800,000 bytes).  Other text viewers are out there.  This one has some advantage
  313. because it's free!  Syntax:
  314.  
  315.     READ [ filespec | @flistfile ] [ /TITLE="title" ] [ /DATE=NONE ]
  316.       [ /line ] [ /MONO | /COLOR ] [ /EGA | /VGA ] [ /-MOUSE ] [ /DOS | /-DOS ]
  317.       [ /Iinitfile | /-I ] [ /Q ] [ /PORT=port ] [ /INITT=string ]
  318.       [ /INITW=string ] [ /AFTERP=string ] [ /AFTERF=string ]
  319.       [ /COLOR=nnn nnn nnn nnn ] [ /? ]
  320.  
  321. READINIT.EXE:  Creates and maintains the READ.INI file which may be used by
  322. READ.EXE, READWK.EXE and any self-viewable file created by READMAKE.EXE.
  323. Syntax:
  324.  
  325.     READINIT [ /MONO | /COLOR ]
  326.       [ Iinitfile | /-I ] [ /PORT=port ] [ /PTYPE=name ] [ /INITT=string ]
  327.       [ /INITW=string ] [ /AFTERP=string ] [ /AFTERF=string ]
  328.       [ /COLOR=nnn nnn nnn nnn ] [ /? ]
  329.  
  330. READMAKE.EXE:  Program which takes an ASCII-text file and makes it
  331. self-viewable.  Provides same capabilities as the READ program.  Syntax:
  332.  
  333.     READMAKE infile [ outfile ] [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  334.       [ /DATE=FILE | /DATE=TODAY | /DATE=NONE ] [ /TITLE="text" ] [ /? ]
  335.  
  336.  
  337. -------------------------------------------------------------------------------
  338.  
  339. Where to find them on the Internet:
  340.  
  341. In general, I no longer upload utilities to computer bulletin boards.  While
  342. users are encouraged to do so, it's a lot easier for me to post them using ftp
  343. on the Internet.  I post them directly on the Simtel archives at oak.oakland.edu
  344. and they are available there using anonymous ftp.  (This site is also mirrored
  345. at lots of different sites.) Subdirectory names have been undergoing some
  346. revisions out there of late but the directories should stay roughly the same.
  347. The version numbers (indicated by the three digits before the .zip extension)
  348. may change as they reflect the last release date of the program ("409" is
  349. September 1994).  The versions listed below are current as of February 1995.
  350.  
  351. Off SimTel/msdos/, look for:
  352.  
  353.      arcutil/av412.zip        Archive view: Free ZIP etc directory viewer
  354.      textutil/bfind501.zip    Boolean FIND command (BFIND BEGIN & END)
  355.      textutil/chang501.zip    Change strings in text files
  356.      spredsht/convr501.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  357.      dirutil/cops407.zip      Copies files modified since given date
  358.      batutil/dates501.zip     Warns you in advance of birthdays etc
  359.      dirutil/dirco501.zip     Updates files based on source directory
  360.      dirutil/dirto501.zip     Directory lister and totaller
  361.      diskutil/fill502.zip     Stuffs as many files as possible on disk
  362.      dirutil/filup401.zip     Copy updated files based on a control list
  363.      textutil/fixtx407.zip    Translate text file characters en masse
  364.      batutil/fortn411.zip     Fine-tunes DOS FOR command w/options
  365.      textutil/isamf412.zip    Full-text searching help desk documents
  366.      textutil/mulco501.zip    Multicolumn text with headers, dBase supported
  367.      textutil/pagin502.zip    Paginates text (headers, indexes, sorting...)
  368.      textutil/read502.zip     Free viewer, also make any text self-viewing
  369.  
  370. Note that the versions above are subject to change.  The last three digits
  371. before ".zip" indicate the last digit of the year and the two digit month.
  372. Depending on how often I've updated things, you might find something like a 410
  373. version instead of 409 when you go to look.
  374.  
  375. If you can't get all of the utilities from your own sources, send $10 to the
  376. address above and I'll send you everything.  Please specify disk size/density
  377. unless you want HD 3.5" diskettes.  If you want to avoid the $10, send me two
  378. HD diskettes in a self-addressed, stamped mailer, and I'll send you everything.
  379. (Again, I'm not out to make money on these.)
  380.  
  381. Another Wayne Software product, called The DEMO System, is released as a
  382. shareware program.  The DEMO System is a unique system designed to create
  383. text-screen demos, tutorials, help screens, etc.  Look for the file
  384. DEMOSymm.ZIP.  On oak.oakland.edu, it's in SimTel/msdos/ as:
  385.  
  386.      screen/demos401.zip      Create tutorials, demos, menu systems, etc.
  387.  
  388.  
  389. --------------------------------------------------------------------------------
  390.  
  391. Beta-zoids...  Thanks to:
  392.  
  393. Beta testers are always desired for these utilities.  You don't get a damned
  394. thing out of being one (which is about what I get for writing them) but it
  395. doesn't cost you much besides an hour or two and lets you have more of an impact
  396. on the future courses of the routines.
  397.  
  398. In order to be a beta tester, you have to be able to receive uuencoded files via
  399. e-mail (so forget CompuServe and Prodigy people; sorry).  If you're interested,
  400. drop a message to me at bgu@cu.nih.gov and tell me which routine(s) you're
  401. interested in being on the list for.
  402.  
  403. Existing routines have gotten suggestions, comments, and even complements from
  404. all over the world (definitely something I *love* about the Internet).  No money
  405. of course but the ego's a powerful thing to feed!  (The flamers of course should
  406. be burned at the stake or maybe start writing their own programs instead of
  407. criticizing other people's.) Thanks to (and sorry for screwing up some of these
  408. addresses and for forgetting to put in others)...
  409.  
  410. CHANGE:         mcardleb@cosy.uml.edu
  411. CHANGE:         rainer.wuerlaender@statistik.uni-muenchen.d400.de
  412. CHANGE:         rallings@gidday@enet.dec.com
  413. CHANGE:         zazovsky@scrsul.sinet.slb.com
  414. CONVERT:        garyjohn@spk.hp.com
  415. CONVERT:        haapanen@niini.metla.fi
  416. CONVERT:        leono@uiuc.edu
  417. CONVERT:        mhenry@sunbelt.net
  418. CONVERT:        rausch@rz.uni-frankfurt.de
  419. CONVERT:        rehmet@studserv.zdv.uni-tuebingen.de
  420. DATES:          fmaxwell@unixg.ubc.ca
  421. DATES:          hans.schrader@geol.uib.no
  422. DATES:          matt.needham@loebbs.com
  423. DATES:          paul.simmonds@jet.uk
  424. DATES:          m965952@kelso.nadn.navy.mil
  425. DIRCOMP:        mcclell@julian.uwo.ca
  426. DIRCOMP:        ornstedt@it.kth.se
  427. DIRTOTAL:       longr@qus102.qld.tne.oz.au
  428. DIRTOTAL:       saracen@cix.compulink.co.uk
  429. DIRTOTAL:       westg@rintintin.colorado.edu
  430. FILL:           beezer@cc.utah.edu
  431. FILL:           dashiell@nadc.nadc.navy.mil
  432. FILL:           doug@io.org
  433. FILL:           pstoffel@zorro.ruca.ua.ac.be
  434. FORTUNE:        thth@forsci.ualberta.ca
  435. ISAMFIND:       doug@io.org
  436. PAGINATE:       esto@loc.gov
  437. READ:           ferch@cca.ubc.ca
  438. READ:           mossako@asterix.uni-muenster.de
  439.  
  440.  
  441. --------------------------------------------------------------------------------
  442.  
  443. Revision history:
  444.  
  445. Detailed revision histories for the programs are only maintained for the last
  446. three releases.  After that, you get the major revision summaries only for the
  447. next three releases.  After that, you get almost nothing.  No one reads this
  448. junk anyway, right?  Programmer types like to put in it in just to justify what
  449. they've been doing over the last couple of years.
  450.  
  451. --------------
  452. Release 95/02:
  453.  
  454. FILL:  Added support for @flistfile specification, allowing the files to be
  455. moved or copied to be in an input file somewhere.  Fixed error which prevented
  456. file from successfully splitting file over 15MB to a 1.2MB diskette.
  457.  
  458. PAGINATE:  Made the output file name optional so FOR commands would run better.
  459. (The default output file name is the input file name with a .PAG extension.)
  460. Dropped the portion in the documentation on transitioning from MULTICOL.
  461.  
  462. READ:  Changed program so that Find brings up text about two lines before the
  463. actual found text.  The also affects READMAKE-created files.
  464.  
  465. --------------
  466. Release 95/01:
  467.  
  468. All routines:  Dropped references to CONFIGWS.EXE in the documentation.  The
  469. use of *.INI files is strongly recommended although CONFIGWS.EXE should still
  470. work for quite awhile.  Also dropped CONFIGWS.EXE from the distribution
  471. version of BFIND (version 501 and after).
  472.  
  473. All routines:  Now accept an environmental variable as another way of setting
  474. the desired defaults.  For example, "SET FILL=/-I" sets the default to not look
  475. for an INI file at all.  "SET DATES=/SORT /D20" sets two defaults for the DATE
  476. program.  The environmental variable is totally optional.
  477.  
  478. BFIND:  Ignored some NOT conditions; fixed it.
  479.  
  480. CHANGE:  Ignored some NOT conditions; fixed it.
  481.  
  482. CONVERT:  Now allows dBase files with memo fields to be read; the memo fields
  483. are automatically ignored however.
  484.  
  485. DATES:  Added the ability to include certain options within a dates input file.
  486. This allows you to change colors and such on the fly.  Specifically, the
  487. following commands can be imbedded within the input file:
  488.  
  489.         /Ddays            (can also be specified for an individual event)
  490.         /DATE=format
  491.         /DATE   and /-DATE
  492.         /DAY    and /-DAY
  493.         /AGE    and /-AGE
  494.         /CTDOWN and /-CTDOWN
  495.         /COLOR=nnn nnn nnn nnn
  496.  
  497. Also fixed up an error when you had leap day dates.  This didn't show up last
  498. year at all because it was a leap year but it generated error messages this
  499. year.  Now, Feb 29 will be treated the same as Feb 28 on non-leap years.
  500.  
  501. DIRCOMP:  Added /Td:\path parameter.  This option was added for some network
  502. administrators who are using the command extensively to update files on
  503. student workstations.
  504.  
  505. DIRTOTAL:  Added /Td:\path parameter.  Program was incorrectly reporting cluster
  506. sizes larger than 32000 bytes; fixed.  Fixed up some summary information
  507. problems when asking for multiple drives.
  508.  
  509. FILL:  Now provides some rudimentary error-detection, which helps in cases of
  510. bad sectors.  Basically tells you to run SCANDISK, deletes the output file that
  511. failed (keeps the source file), sets a return level of 252, and returns you to
  512. DOS.  Modified the way that /FORMAT worked for 360K and 720K diskettes; DOS for
  513. some reason tries to reformat 360K diskettes as 1.2MB diskettes and that's not
  514. all that healthy.  Added a percentage done for the total bytes copied/moved.
  515. Added /TIME and /-TIME parameters; skipping the transfer speed information is
  516. the default (used to always show).
  517.  
  518. MULTICOL:  Maintenance release.  Modified documentation to indicate that this
  519. would be the last release of this program; PAGINATE does more and that's the
  520. program I'll be maintaining.
  521.  
  522. PAGINATE:  Bug fixes.  Changed it so that INDENT n-n worked on the first word vs
  523. the first letter (allowing you to do more interesting bulleted items).  Added
  524. ADJUST and -ADJUST to control widow lines.  Documented the /DEBUG parameter.
  525. Frankly, this program works a lot better than I expected it would!
  526.  
  527. --------------
  528. Release 94/12:
  529.  
  530. AV:  Added some more keystrokes to the viewer; Up, Down, Ctrl-C, Home, and End.
  531. Also added complete mouse support for the routine, adding a mouse button bar
  532. and allowing you to select whichever options you want to select.  Added /MOUSE
  533. and /-MOUSE parms.
  534.  
  535. CHANGE:  Fixed a problem which occassionally dropped characters from the output
  536. file.
  537.  
  538. FILL:  Fixed a bug with LABEL=label specifications that included more than one
  539. "n".  Didn't like the way that /PROMPT work so fixed that up a bit.
  540.  
  541. ISAMFIND/ISAMMAKE:  Fixed quite a number of quirks and bugs.
  542.  
  543. PAGINATE:  First release.  This is a rather powerful document formatter that
  544. I've wanted to write for awhile and has been languishing for lack of effort for
  545. almost as long.  Has an incredible number of options, all of which worked at
  546. least once for me when I was coding it but some of which probably no longer do.
  547. Let me know.  I fix things (maybe as well as I break things).
  548.  
  549. -------------- (kind of terse; revisions made 4 to 6 months ago)
  550. Release 94/11:
  551.  
  552.   DATES:  Now allows you to specify dates relative to the day of the week.  Also
  553.   added /SORT, /-SORT, /CTDOWN, and /-CTDOWN parameters.  Added support for
  554.   event-by-event date threshholds.
  555.  
  556.   DIRTOTAL:  Dropped /Z2 parameter.
  557.  
  558.   FORTUNE:  Added support for command files for help with redirection needs
  559.   (including ftp use).
  560.  
  561.   ISAMFIND/ISAMMAKE:  First release.
  562.  
  563. Release 94/10:
  564.  
  565.   CONVERT:  Added /FIRSTOBS=n and /LASTOBS=n parameters.
  566.  
  567.   DATES:  Added various screen pausing options.
  568.  
  569. Release 94/09:
  570.  
  571.   BFIND:  Added the ability to include hexadecimal codes in the find string.
  572.  
  573.   CONVERT:  Lots of bug fixes (including one involving ASCII-delimited input
  574.   files that didn't have any quoted strings in them).
  575.  
  576.   DATES:  Added /DATE=form option to let you specify different formats for the
  577.   input dates.  For example, /DATE=dd/mm/yy.  Added ability to read months in
  578.   JAN, FEB, MAR, etc form.
  579.  
  580. Release 94/08:
  581.  
  582.   BFIND:  Added /Iinitfile and /-I parms.  Only program temporarily retaining
  583.   CONFIGWS.*.
  584.  
  585.   DATES:  Added /R, /DAY, /MONO, /COLOR, /SKIP, and /-SKIP parameters.  Allowed
  586.   for up to 10 input files and comments within files.
  587.  
  588.   FILL:  Added /FAKE parameter.
  589.  
  590.   FORTUNE:  Added /Iinitfile and /-I parms.
  591.  
  592. Release 94/07:
  593.  
  594.   All:  Added support for /Iinitfile and /-I parms, dropping CONFIGWS.*.
  595.  
  596.   DATES:  Added /-I, /CLS, /-CLS, /COLOR=nnn nnn nnn, /Q, and /-Q parameters.
  597.  
  598.   READ and READINIT:  Made READ's use of hexadecimal codes (previously /nnn)
  599.   consistent with the other Wayne Software routines (use \nnn or &Hxx instead).
  600.   Converted the READ.INI file to the newer initfile system.
  601.  
  602. -------------- (real terse)
  603. Release 94/06:
  604.   New:  DATES.
  605.  
  606. Release 94/02:
  607.   New:  FORTUNE.
  608.  
  609. Release 94/01:
  610.   New:  COPSINCE and FIXTEXT.
  611.  
  612. Release 93/03:
  613.   New:  AV and READINIT.
  614.  
  615. Release 93/01:
  616.   First release posted on SIMTEL (Internet).
  617.   New:  The DEMO System (shareware and not part of normal package).
  618.  
  619.